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Development Tool Support 


+ Great tool experience expected by 
developers 


+ Tools require support from class library 
writers to make this happen 


+ Microsoft® IntelliSense® hints 
٠ Help documentation 

+ Debug viewers 

+ Designer support 


e Microsoft Windows® Forms 
Designer “Whidbey” 
Features 


Demo 


+ 


«75 Technical Foro 


Enabling Technologies 


+ Metadata attributes / XML Doc Comments 
» Object model guidelines 
+ Custom code to support tools 


Metadata Attributes 


« Designers 

« Description 

« Browsable 

« Bindable 

+ ListBindable 

* Defaultvalue 
* IntelliSense 

4 EditorBrowsable 

* XML Documentation 
+ Debugging 

« DebuggerDisplay 

« DebuggerBrowsable 


Metadata Attribut 
Example: Bad Experience 


publi 


pub] 


public int Radius { 


Center 


Metadata dredh 


E xampl e: Good 


public class Circle 1 
Description C The center of the circle_")] 
public Point center { get; set; } 
public int Radius { get; set; } 


The center of the circle, in pixels. 


aa Solution Explorer | SP Properties 


Example: Bad Experience 


public FileInfo 


pub] ing Path 


Path to 
what? 


XML Documentation 
Example: Good Experience 

/// «summary» 

/// The fully-qualified path. 
/// </summary> 

public string Path { get; } 


Eve riento pen 
Saya d peri to the fle, excudng 


XML Documentation 


Filtering 


fff «filterprioritys2«/filterprioritys 
[Edi torBrowsable (EditorBrowsableState .Advanced)] 
public string Path { get; } 


Object Model Guidelines 


» Object or Component? 
+ Object: lightweight, transient, or utility 


+ Component: properties, events, configure 
and use pattern 


+ Properties 
» No interdependencies 
+ Exceptions on setters only 
» Constructors 
» Components should have an empty ctor 


+ 


Techmicm 上 


Custom Tool Code 


+ In COM, you had a flag and a few heuristics 
» Everything was a component 
+ Custom data types were minimal 


+ In Microsoft .NET, you have design-time 
classes 


+ Modify or augment runtime behavior, but 
don't bloat runtime object 
+ Examples: Debugger Type Proxies, Type 
Converters, Designers 
+ 


Technicm : 


Debugger Tape pee 


Exampl 


public class Hashtable : IDictionary { 
1 


User plays "find 
the bucket" 
Irrelevant 


implementation 
details exposed 


Depugger Type Proxies 


DebuggerTypeProxy (typeof (HTDebugview))1 
public class Hashtable : IDictionary { 
class HTDebugview { 
public HTDebugview(Hashtable ht) {} 
r 


What the user 
expects 


“Raw View” still 
available 


Type Converters 


public class Circle { 


public Point Center { get; set; } 
public int Radius { get; set; } 


Causesvslidati True 
Grde 
ContetMenu (none) 


. Can't be edited 


- Doesn't display any useful information 
: Can't persist to XAML or code 


Type Converters 


amp m 0 


u 
100,100:10 
E Center 100, 100 
x 
Y 


Radius 
ContextMenu 


+ CircleConverter provides two features 
* Text-to-value and value-to-text conversion 
« Indicates that object exposes properties 
« Property Grid and XAML happy, but no code generation yet 


Type Converters 


Circle c = (Circle)value; 
Constructorinfo ctor = typeof (Circle). 
GetConstructor (new Type [] { 
typeof (Point), 
typeof Cint) Dj 
return new InstanceDescriptor (ctor, 


new object [] { c.Center, c.Radius 1); 


yControll.Circle = new Circle(new 
+(100, 100), 10 


Task 
Writing a TypeConverter 
+ Priority 1 
+ Bi-directional string-to-value conversions 
+ ConvertTo InstanceDescriptor for code 
+ Priority 2 
+ Provide expandable properties 
+ Provide standard values for selections 
+ Priority 3 
» Bi-directional byte[] for binary blobs 
+ 
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Designers 
What Are They? 


+ Class that is instantiated by the tool to change 
the behavior of a run-time object 
» Defaults provided for common base classes 
+ IComponent 
» Control 
+ FrameworkElement 


» Same architecture, but different models for 
each ASP.NET, Windows Forms, “Avalon” 


+ 
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Tool Extensibility 


Microsoft fi 
Visual Studio J 


Delphi L 


Eo psa [ | Design-Time Code 
Public _/ 
API | Runtime Object Model 


Technical Foro 


Lesson 11 Summary 


» Developers expect a rich tool experience 

» Enabling this experience requires work from 
API developers 

+ All public APIs are candidates, so include this 
in your schedule 
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